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BACKGROUND INFORMATION 

Software translation systems developed by the assignee of the 
present application and other companies may use lookup tables or 
symbol tables at the "front-end" of the system, i.e., to read a 
source file. A typical table-based translation contains an ad-hoc 
table of items to be read from the source format. The items in the 
table are usually very closely tied to the lexicon and syntax of 
the source format. By modifying the table, the user may 
accommodate minor differences between different source formats. 
Disadvantageously, however, these lookup tables have difficulty 
handling more substantial differences in syntax. Part of a 
conventional table is shown below. 



{cmtEnd} "*/" 
{cmtSt} '*/*" 



Whenever the program reads "/*", it interprets that as a comment 
beginning. Whenever the program reads "*/", it interprets that as 
a comment ending. 

More sophisticated translation tools often break the read 
process into two stages, each of which may be table-based. The 
first stage, referred to as a lexical analyzer, breaks the input 
into logical units called tokens. The second stage then assigns 
meaning to the tokens. The languages LEX and YACC are examples of 
such a lexical analyzer and parser. Even in these sophisticated 
languages it is difficult to read some common language constructs. 
Moreover, although this front-end arrangement may permit a user to 
specify some lexical and syntactic differences between source 
formats, they generally do not permit a user to input source files 
of different overall structure. Moreover, these translation tools 
may use a table for the front-end of the translation, but not the 
back-end (i.e., the output end) of the translator. For these 
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reasons, such translators do not permit a user"to translate 
multiple input formats to multiple output formats, but rather, are 
generally language-specific. 

These drawbacks generally stem from their use of the 
conventional approach of mapping particular commands to particular 
functions. This approach creates an often artificial one-to-one 
mapping of statements in one language to statements in another 
language. The meaning of the statements are irrelevant in these 
translations except that particular statements in the source format 
translate to particular statements in the target format. 

This one-to-one mapping is similar to the approach generally 
used by compilers. For example, a compiler reads the internal 
representation of a program command by command. It looks each 
command up in a code generation table and looks variables up in a 
symbol table. For each command it substitutes a sequence of 
machine instructions found in the code generation table. As the 
compiler encounters variables in the instruction sequence, it looks 
the variables up in the symbol table and either locates the data in 
registers or assigns relocatable memory addresses to the data. 
Conventional code optimization routines may also be used before the 
back-end. 

In addition, compilers generally translate to a context-free 
grammar. Such a grammar allows the source format (syntax) to be 
read as a "tree" structure, to effectively "de-nest" nested 
functions prior to sequentially writing instructions. In such a 
tree structure, elements that are defined in terms of other 
elements form the branches (non-terminal nodes). Elements that are 
not defined in terms of other elements form the leaves (terminal 
symbols) and ..may be referred to as tokens. From this grammar, a 
tool may be created that takes specific actions when specific 
terminals (tokens) are encountered. Because the grammar defines 
the syntax it is necessarily closely tied to the source syntax. 
For example, the following is a context free grammar for 
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translating addition and subtraction from standard notation into 
conventional post-fix notation (non-terminals are in italic) : 

expression -> term therest 

therest -> + term | - term rest | empty 

term -> number 

This grammar translates a context-sensitive expression such as 24 - 
3+15 into the context-free post-fix expression 24 3 - 15 +. 

The "un-nested" context-free grammar thus may be used to 
represent an internal representation that is more convenient to 
process. This internal representation may then be used to generate 
a sequence of commands in the target format. 

Conventional file format translators are generally based upon 
this compiler-like approach of translating commands in the source 
format to commands in the target format. Such an exhaustive, 
formal analysis, however, tends to be more appropriate for a 
compiler or interpreter, where every single command must be 
converted into the proper sequence of CPU instructions. Because 
the files (e.g., formatted text documents) translated by a file 
translator have a different structure than programs (e.g., 
executable files) translated by a compiler or interpreter, a file 
format translation program must take a different approach. 

For example, executable programs are composed of commands and 
variables or memory and register accesses. Commands tell the 
computer to do something and variables tell the computer where to 
access information. Documents, on the other hand, are better 
characterized as a series of features rather than a series of 
commands. Where commands manipulate variables, features contain 
static data. Where variables tell a program how to find data, the 
feature itself tells a document how to find data. 

Moreover, in a program, a variable may contain the location of 
data rather than contain the data itself (usually referred to as a 
pointer) . In some cases a variable may be a pointer to a pointer. 
In a document, on the other hand, the data is often composed of 
features which each contain data. That data then is often composed 
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of more features, and so on. For instance,, the main text flow 
feature of a text document contains paragraph features. Each 
paragraph feature contains text features. Each text feature 
contains the text itself. Moreover, many potential target formats 
explicitly store documents as tree structures. In these formats 
all commands either come in pairs (a beginning command and an end 
command) or have a beginning and an end with data stored between 
the beginning and end. 

For example, XML commands either take the form: 
<command>Data</ command> or take the form Kcommand Attribute_Data> . 

In the first form, Data can be simple text or more commands. In 
the second form, Attribute_Data is numeric, string, or other simple 
data that follows formatting conventions specified for that flavor 
of XML. The Adobe® FrameMaker® MIF format (Adobe Systems 
Incorporated, San Jose, CA 95110-2704) also has a tree structure 
that takes the form <command Data>. In MIF Data can be numeric, 
string, or a command. 

Thus, a need exists for an improved file format translator 
that addresses drawbacks associated with the prior art. 



SUMMARY 

According to an embodiment of this invention, a translator 
is provided for translating a source file in a source format to a 
target file in a target format. The translator includes a 
feature identifier to determine a feature set of the source file, 
and a feature writer to write the feature set into the target 
file in the target format. 

In optional variations of this embodiment, the feature 
identifier includes a front-end lookup table to map code 
fragments of the source file to a list of features. The feature 
writer may include a back-end lookup table to map the feature set 
to code fragments of the target file format. 

In another embodiment of the present invention, a method is 
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5 provided for translating a file from a sourcTf ormat to a target 
format. The method includes identifying a feature set of a 
source file, and writing the feature set into a target file in 
the target format. +- 

In a further embodiment, a method is provided for 
configuring a system to translate a source file in a source 
format to a target file in a target format. The method includes 
providing a feature identifier to determine a feature set of the 
source file, and providing a feature writer to write the feature 
set into the target file in the target format. 

A still further embodiment includes a system for translating 
a source file in a source format to a target file in a target 
format. The system includes a feature identifier to determine a 
| feature set of the source file, and a feature writer to write the 

. feature set into the target file in the target format. Another 
J 20 embodiment includes an article of manufacture for translating a 
jjj source file in a source format to a target file in a target 
W format. The article. of manufacture includes a computer usable 
^ ■ medium having a computer readable program code embodied therein. 
P The computer usable medium includes computer readable program 

code for identifying a feature set of the source file, and 
computer readable program code for writing the feature set into 
the target file in- the target format. 

Another embodiment of the present invention includes 
computer readable program code for translating a source file in a 
source format to a target file in a target format. The computer 
readable program code includes computer readable program code for 
identifying a feature set of the source file, and computer 
readable program code for writing the feature set into the target 
file in the target format. 



u 25 



35 



BRIEF DESCRIPTION OF THE DRAWINGS 

The above and other features and advantages of this 
invention will be more readily apparent from a reading of the 
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5 following detaileXdescription of various aspects of the 

invention taken in conjunction with the accompanying drawings, 
in which: 

Fig. 1 is a block diagrammatic view, with optional 
portions shown in phantom, of an embodiment of the present 
o invention; 

Fig. 2 is a block diagrammatic view, with optional 
portions shown in phantom, of an alternate embodiment of the 
present invention; and 

Fig. 3 is a block diagrammatic view, with optional 
5 portions shown in phantom, of elements of the embodiments of 
Figs . 1 and 2 . 

DETAILED DESCRIPTION 

Referring to the figures set forth in the accompanying 
Drawings, the illustrative embodiments of the present invention 
o will be described in detail hereinbelow. For clarity of 

exposition, like features shown in the accompanying Drawings shall 
be indicated with like reference numerals and similar features as 
shown in alternate embodiments in the Drawings shall be indicated 
with similar reference numerals. 

Briefly described, embodiments of the present invention permit 
a user to effect translations between files of significantly 
distinct formats. These embodiments use discrete lookup tables for 
the back-end of the translation, to advantageously facilitate 
writing a wide variety of formats. These embodiments collect data 
by finding feature parts of a source file, (rather than individual 
instructions) followed by assembling these feature parts, and then 
writing the collected data in a tree-structure format. 

Referring now to Figs. 1-3, the embodiments of the present 
invention will be more thoroughly described. Turning now to Fig. 
1, an embodiment of the present invention is shown as generic file 
format translator 100. This translator is capable of translating 
source file formats (interchangeably referred to herein as source 
files) 110 to other (target) file formats (interchangeably referred 
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to herein as target files) 112 having mutually^listinct internal 
structures, but similar features and levels of abstraction. For 
example, in a particular implementation, translator 100 may 
translate FrameMaker® ) source files 110 to WINHELP® (Microsoft 
Corporation, Redmond, Washington) target files 112, or to HTML on- 
line help files. Additional options include translation between 
graphic file formats, spreadsheet file formats, or between 
executable file formats. Translator 100 effects such translation 
without re-compiling the source file or program. 

Instead of translating commands in the source format 110 to 
commands in the target format 112, embodiments of the present 
invention use a feature identifier 114 to identify a set of 
features in the source file 110 that will be translated. As used 
herein, a feature may include a paragraph style, straddled cells in 
a table, cross-referencing, pen styles in a drawing, etc. 
Additional features may include other document formatting, document 
header specifications, document footer specifications, 
discontinuity indicators, order indicators, location indicators, 
beginning indicators, ending indicators, data types, data . 
translation pairs, document macros, implied features, implied 
feature endings, and combinations thereof. As translator 100 reads 
through the source file 110 it collects information about the ~ 
features. Unlike conventional translators or compilers that look 
for and translate on an individual command-by-command basis, the 
translator 100 identifies features that may be represented by a 
command, a parameter of a command, or multiple commands spread 
throughout the source file 110. These feature representations are 
variously referred to herein as tags. Translator 100 may assemble 
the description of the features read by identifier 114 as an 
intermediary representation, stored in any convenient manner such 
as in a buffer or RAM (random access memory) . This intermediary 
representation and the storage media (e.g., buffer) in which it is 
stored, are interchangeably referred to herein as intermediary 
representation or buffer 116, 216. When the translator 100 has 
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read a complete description of the features of source file 110 and 
completely assembled the representation 116, translator 100 may use 
writer 118 to write a series of commands (also referred to herein 
as code fragments) that describes each of the identified features, 
to produce the target file 112. 

Thus, rather than being syntax-directed, embodiments of the 
present invention are feature directed. Being feature directed, 
translator 100 is less closely tied to any particular file format 
than syntax-directed translations, and is thus relatively generic. 

Translator 100 may optionally use tables at the front end 
and/or the back end to associate features with various code 
fragments or tags. For example, as shown in phantom, feature 
identifier 114 may optionally include a front-end table (also 
referred to as a front-end tag file) 120 in the form of a lookup 
table that includes specific tags associated with individual 
features in source format 110. Similarly, writer 118 may include a 
back-end table (also referred to herein as a back-end tag file) 122 
in the form of a lookup table that includes specific tags 
associated with individual features in the target format 112. In 
operation, the writer 118 functions similarly, though in reverse, 
to the identifier 114, querying the intermediary representation 116 
for the next feature, looking that feature up in the table of code 
fragments (tag file) 122, and then writing the corresponding 
sequence of code fragments required to produce the particular 
feature. Translator 100 thus may include both a table-based front- 
end and a table based back-end. In light of the foregoing, as used 
herein, the term "tag file" shall be used to interchangeably refer 
to look-up tables disposed either in the front-end, such as table 
120, or in the back-end, such as table 122. 

The lookup tables associate each feature to a code fragment 
(tag) beginning and a code fragment (tag) end. In lookup table 
122, each feature may either be mapped to a single command in the 
target language, or to a sequence of commands with no associated 
data plus a single command with data. For example, when the file 
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writer 118 encounters the beginning of a feature (i.e., in the 
intermediary representation 116) it looks the feature up in lookup 
table 122 and writes the corresponding beginning code fragment 
(tag) . When the file writer 118 encounters data, it writes the 
data directly to the target file 112. When the file writer 118 
encounters the end of a feature, it looks the feature up again in 
table 122 and writes the corresponding end code fragment. 

This method of separating beginning code fragments (tags) from 
end code fragments (tags) permits translator 100 to easily 
translate to conventional tree-structured file formats, such as MIF 
or XML . This ability is in contrast to conventional code 
generation tables typically found in compilers, which tend to only 
allow generation of sequentially structured formats. 

Moreover, in the event a target file format is not a tree 
structure, it may still be written as if it were. In general, non- 
tree file formats will represent features as one or more commands 
followed by data, or data followed by one or more commands, or a 
command containing data. In the first instance, the commands may 
form the "beginning code fragment" of the tree structure, and the 
"end code fragment" may simply be empty. In the second case the 
"beginning code fragment" of the tree structure may be empty, with 
the commands located in the "end code fragment". In the final case 
the beginning of the command may be located within the "beginning 
code fragment" and the end of the command may be located within the 
"end code fragment". 

Programs which save files in a tree structured language like XML 
usually do not use a lookup table to handle writing because these 
programs typically are designed to write one flavor of XML or one 
particular file format (so a lookup table is unnecessary) . Even 
programs that may use a lookup table (such as the FrameMaker® HTML 
writer, and Quadralay® Webworks™, (Quadralay Corporation, Austin, 
Texas), the programs do not use a feature-based reader. This means 
the output is limited to slightly different interpretations of the 
same output format or to closely related flavors of a generalized 
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format like XML. Embodiments of the present invention thus 
advantageously use a feature-based reader which allows it to use a 
back-end lookup table 122 that is flexible enough to write nominally 
distinct tree structured formats, sequential formats, post-fix 
formats and other discrete file format structures. 

As a further alternative shown in phantom, while using the 
aforementioned feature-based back-end writer 118, feature analyzer 
114 and front-end table 120 may include a two-step system including 
a lexical analyzer 180 coupled to a table 182 for identifying 
tokens within the source file 110, and a feature collector 184 
coupled to a feature collection table 186 for associating features 
with the tokens. 

Having described an embodiment of the present invention, 
operation of embodiments of the present invention is now discussed. 

In a general implementation of translator 100, a file is 
created in the source format 110. Translator 100 reads the source 
file 110 with analyzer 114 using look-up table 120 to interpret 
commands associated with translatable features. Commands not 
associated with translatable features are ignored. When translator 
100 has assembled a complete description of the features (and 
optionally stored the features in intermediary representation 116), 
writer 118 looks the features up in the back-end lookup table (tag 
file) 122. A section of this table 122 indicates where the program 
can write each of the features in the target file 112. Other 
sections of table 122 may specify how the feature should be 
written. Intermediary representation 116 may serve as a convenient 
buffer to retain feature information while subsequent features are 
analyzed, such as in the event the sequence of features needs to be 
re-organized before writing to the target format 112. When the 
writer 118 is ready to write a feature, it does the following: 

1. Takes the beginning code fragment (tag) from the tag file 
122, and writes the tag to the target file 112. 

2. Takes the data and performs any manipulations specified in 
the tag file 122, then writes the data to the target file 



11 



10 



15 



Docket No.: 200^^34/1109.007 

112. These manipulations are generally relatively simple 
unit conversions, such as integer to ASCII or inches to 
centimeters, etc. 
3. Takes the ending code fragment (tag) from the tag file 122, 
and writes the tag to the target file 112. 



In addition, translator 100 may include one or more sample 
front end or back end tag files 120, 122 for particular formats. 
Users may take these sample tag files and modify them for their own 
customized applications. In a particular embodiment, such tag file 
modifications may be effected through a conventional Graphical User 
Interface (GUI) 234, such as shown in Fig. 2. 

Turning now to Fig. 2, a more detailed embodiment of the 
p present invention is shown as translator 200. In a typical 
^ embodiment of the present invention, the translator 200 may need to 
2 20 read mul tiple files with different source formats 110. To 
M ' facilitate this, a plug-in 230 to the file-generator program (i.e., 
W the program that creates the file 110) may be used to help prepare 
the file 110 for translation. For example, a conventional on-line 
0 help system generally requires a table of contents. A conventional 
C 25 Piug-in for the FrameMaker® program is generally used to execute a 
j| ■■ sequence of steps necessary to generate the table of contents in 
j; the FrameMaker® book file 110. A similar plug-in 230 may invoke 

translator 200 to handle the actual translation from a FrameMaker® 
book file 110 to FrameMaker® MIF files 232. For example, as shown, 
30 MIF files 232 may include one or more MIF book files 240, MIF table 
of contents files 242, MIF index files 244, and MIF chapter files 
246. These MIF files may then be analyzed as discussed hereinabove 
by analyzer 214. 

In addition to MIF files 232, analyzer 214 may analyze C/C++ 
35 header files 210, such as may be desired to translate files in a 
conventional context-sensitive Help system. For example, if the 
target file 212 is a form in a conventional context-sensitive Help 
system, then analyzer 214, in combination with front-end table 220, 
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may read C/C++ header files (or JAVA resourceTiles) 210 associated 
therewith, to determine the conventional topic Ids of the context- 
sensitive topics. Analyzer 214 and table 220 may also derive any 
dynamic elements of the source file 110, such as table of contents, 
and index entries, which may be subsequently used by writer 218 and 
tag file 222 to generate corresponding features, such as a Contents 
Dialog and Keyword Index for WINHELP® (Microsoft® Corporation) Help 
files . 

Additional file formats that may be read by translator 200 
include, for example, WMF (Windows Metafile Format) files, which may 
be translated into SVG (Standardized Vector Graphic) or Flash™ files 
(Flash™ is an open format published by Macromedia Inc., San 
Francisco, California) , to enable vector graphics to be used in HTML 
based help files. Any front-end add-ons or plug-ins 230 may 
optionally be enabled to read two or more source formats. 

In the event the desired target format is a public or open 
format such as HTML, RTF, SVG, or Flash, the process may be 
complete 254 once the writer 218 generates the target file 212. 
Alternatively, the translator 200 may determine 252 whether the 
target format 212 requires further translation. For example, in 
the event the desired target format is non-public, (such as the 
WinHelp® format) additional translation may be required to convert 
the public target file 212 into the desired (non-public) final 
format 212' . To accomplish this additional translation, a tool 
250, such as may be provided by or on behalf of the owner of the 
non-public target format, may be used to convert the public format 
212 into the non-public format 212' . In the example shown, the MIF 
files 232 may be translated to RTF files at 212. A Help Compiler 
available from Microsoft® may then be used at 250 to convert the 
RTF to the non-public WinHelp® format. Moreover, in addition to 
RTF files, the target 212 may include files in the HPJ (Help 
Project File) format to provide instructions to the Help Compiler. 

Additional file formats that may be translated (i.e., that may 
serve as either source or target formats) include WordPerfect® 
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5 (Corel Corporation, Ottawa, Ontario, Canada) , T£rel® VENTURA* 
(Corel Corporation) Microsoft® Word, BroadVision® Interleaf 
(Redwood City, California), HTML, SGML, XML, C, C++, Visual Basic® 
(Microsoft®), Pascal, Java™ (Sun® Microsystems, Inc., Palo Alto, 
California) , MFC, MetroWerks® PowerPlant, Swing™ (the Sun® 
10 development framework for Java) , SVG, HPJ, Flash, Microsoft® WMF 

(Windows Meta File), VRML (Virtual Reality Markup Language), Pixar® 
RenderMan® file formats (procedural, shader, and RIB) , (Pixar 
Animation Studios, Richmond, CA) , Apple® 3DMF (3D MetaFile) (Apple 
Computer, Inc., Cupertino, CA) . The skilled artisan will recognize 
15 that substantially any file format now known, or developed in the 
future, may be translated by embodiments disclosed herein, without 
departing from the spirit and scope of the present invention, 
g Turning now to Fig. 3, various aspects of tag files 120, 

:jj ' 220 ' 122 ' 222 > are described in greater detail. Examples of 
j 20 portions of these tag files are shown hereinbelow with respect to 
jjj . embodiments associating features with tags in the ASCII format, 
y The skilled artisan will recognize that alternate embodiments may 
T associate features with tags in substantially any format, such as 
g RTF, HTML, SGML, XML, other SGML-like formats, and any other 
M 25 format men tioned herein, etc., without departing from the spirit 
J" and scope of the Present invention. As shown, various features 
|J. or components of features identified in an exemplary tag file 
include begin and end code fragments 2 60, Global Project 
Properties (such as Book-wide Properties in FrameMaker®) 262, 
30 document Header and Footer specifications 2 64, the order of 
features 266, discontinuity indicators 268, feature locations 
270, data translation pairs 272, macro data types 274, feature 
data types 276, implied features 278, and implied feature endings 
280. Additional features may also be included. As discussed 
35 hereinabove, the tag file 122, 222, describes how to write 

features in the target format from the features identified by 
analyzer 114, 214 (and optionally assembled in the intermediary 
representation 116, 216). Similarly, tag file 120, 220, 
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5 describes how to create the intermediary representation 116, 216 
from the original source 110, 210. Some aspects of the tag file 
shown in Fig. 3 serve to help the translator 100, 200 determine 
whether it has collected/written a complete feature. 

Exemplary coding format and/or examples of various aspects 
10 of tag file 120, 220, 122, 222, shown and described with 

respect to Fig. 3 are set forth hereinbelow in conjunction with 
Appendix A. It is to be understood that these examples should 
not be construed as limiting. 

An exemplary format for tag files 120, 220, 122, 222, is 
15 generally simple so that it is relatively easy to parse. For 

instance, Comments may start with #. Features may be divided into 
categories. Categories may be introduced with a header surrounded 
by square braces []. Each block set forth in Fig. 3 and discussed 
hereinabove may be introduced with a header surrounded by curly 
20 braces { } . Each feature category in the code fragment section may 
then be introduced with a header surrounded by square braces. 
KJ Features may be named with keywords that start at the beginning of 
=; • a line and are followed by an equal sign (=) . Spaces may not 
2 . allowed before the equal sign unless they are part of the keyword. 
I s *. 25 Fields on the right side of the equal sign are separated with a 
% semi-colon (;). If the target format uses semi-colons, then they 

I-*;'"" are replaced with the string %semi%. Any line beginning with Text= 
is a quoted line. The category in which this line occurs 
determines how the text after the equal sign is used. A brief 
30 example of some aspects of this coding format is shown as Example 1 
in Appendix A hereof. 

Global Project Properties 262, for example, may be written to 
a project file. In a document translation, global properties 2 62 
include things such as a list of document files in the translated 
35 book, paths to included graphics, and the title on a resulting help 
system display. WinHelp® translations may require a help project 
file with the extension HPJ, while HTML Help may not require a 
project file. If the tag file 122, 222, defines a translation to 
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Winhelp® it may have a section header: [projectFile=hpj ] . If the 
target format is a different system that required a project file 
with a different extension, such as prj, then the section header 
may be: [projectFile=prj ] . After the section header a series of 
"Text" keywords may specify the contents of the project file. For 
instance, Text=OLDKEYPHRASE=NO, indicates that the line 
" OLDKE Y PHRAS E=N0 " should be included in the project file. 
Alternately, the file extension may be removed from the header and 
placed in an "extension" feature in the {projectFile} section. In 
the MIF to RTF translation the projectFile section specifies the 
resulting help project (HPJ) file. Portions of the file that 
remain constant from translation to translation may be specified as 
literal strings. Portions that change may be specified as 
variables. Variable identifiers may be plain-text strings quoted 
with percent signs on either side. For example %contentsTopic% is 
a variable. Although embodiments of the present invention may use 
variables, their use is discouraged because they may make the 
translation less generic. Rather specific embodiments of the 
present invention may replace all variables with features that have 
beginning and end code fragment pairs. 

Text that replaces a variable may be generated from 
information gathered from the source (e.g., FrameMaker®) book file 
and information gathered while reading the FrameMaker® document 
files. The translation may not finish writing the HPJ file until 
the last document has been read. For instance, Text=%FileList% , 
indicates that a list of files derived from the FrameMaker® index 
of references should be included in the project file. As the 
translator 100, 200 reads the FrameMaker® document, it constructs a 
list of files. After the last document is read, the translator 
writes the HPJ file. When it encounters the %FileList% variable, 
it dumps the collected list to the HPJ file. An exemplary RTF Tag 
File is shown as Example 2 in Appendix A. An exemplary portion of 
an HPJ (Help Project file) file is shown as Example 3 in Appendix 
A. 
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Exemplary Document Header and Footer Specifications 264 are 
now discussed. Most file formats tend to have a header or footer 
containing document-wide parameters. Unlike project files, which 
generally apply to a group of files, headers and footers generally 
apply to a single file. Some file formats also have a footer with 
other document-wide parameters. Like project properties, the bulk 
of the header or footer is specified as literal text. The parts 
that change from document to document or from translation to 
translation may be specified as variables. Usually the header, 
body, and footer are written sequentially with the header first. 
If some of the information written to the header is not found until 
the entire document file has been read, then the tag file may 
specify that the header is written last. After all three 
components (header, footer, text) have been written (e.g., by 
writer 118, 218) or buffered, the translator 100, 200, may re- 
assemble them in the correct order in the target file 112, 212, 
212' . An example of Document Header and Footer Specification 264 
is shown as Example 4 in Appendix A. 

Feature Order 266 is now described. In some file formats 
features must be written in a specific order relative to one 
another. If order is important in any of the target formats, the 
required order may be specified in the tag file. In an exemplary 
HTML Tag File, the following entry in the { f eatureOrder } section 
specifies that a jumpLink feature is composed of a jumpID feature 
followed by a jumpText feature. 

jumpLink=%$ jumpID$$ jumpText$% 

In an exemplary RTF Tag File, the following entry in the 
{ f eatureOrder } section specifies that a jumpLink feature is 
composed of a jumpText feature followed by a jumpID feature. 

jumpLink=%$ jumpText $$ jump ID $% 
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If a target format required the ID to be placed after the 
jumpText, but before the end jumpText code fragment, the 
specification may be: 

j umpLink=% $ j umpText $<DATA>< $ j umpID$ > % 



Tag file items that specify the beginning and ending 2 60 of a 
feature may be code fragments. It is up to the user who writes the 
tag file 120, 122, 220, 222, or the GUI 234 that builds the tag 
file to create fragments that conform to the target format syntax. 

The translator 100, 200 may paste these code fragments together 
with data from the source file 110, 210, building up the target 
file 112, 212, 212', like a patchwork quilt. 

Other sections of tag file 120, 220, 122, 222, are optional. 
When a user is expected to specify collections of features with a 
style in the source format, each style may be treated as a separate 
feature in the tag file. For example, FrameMaker® has paragraph 
styles, character styles, and table styles. Each paragraph style 
defines spacing, fonts, alignment, and other features. A tag file 
that translates MIF to RTF should treat each paragraph style as a 
separate feature. Likewise, each character and table style should 
be a separate feature. 

For instance, the tag file might specify that the MIF 
character style "strong" gets translated to the RTF character style 
"cs7" which has the format 12pt Ariel bold-italic. The beginning 
fragment then switches to 12pt Ariel bold-italic text. The end 
fragment switches back to the default text format. 

FrameMaker®, RTF and HTML share the concept of paragraph style 
tags. If the tag file defines a translation to RTF (which is then 
translated to Winhelp) , or HTML, then there is a [pgfTags] 
section. This [pgfTags] may be treated as a category of 
{ code Fragments } . Each feature in this section may be the name of a 
paragraph style tag. After the equal sign several fields are 
specified, separated by semicolons (;). Each field after the third 
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may be optional. The first two fields specify how to start a 
paragraph of the indicated style. (The first field goes at the 
beginning of a table row if the paragraph is part of a table. The 
second field goes inside a table cell if the paragraph is part of a 
table.) The third field specifies how to end the paragraph style. 
If the fourth field exists, and is not blank, it indicates whether 
the paragraph begins a new topic or TOC entry. This field also 
specifies the level of the heading so the TOC can be automatically 
reorganized if necessary. The fourth field may be moved to a 
different section. For example: 

paragraphStyle=%$paragraph$<$defaultFont$XDATA>% 

The following specifies a Heading 1 style tag for an RTF 
target file: 

Heading I=\s430\sal20\sb50\keepn\widctlpar ; \cf 13 \b\f 5\f s28\kerning28 ; 
;Y4 

The resulting RTF when some Heading 1 text reads "This is the 
Heading 1 Text" would be: 

\s430\sal20\sb50\keepn\widctlpar\cf 13 \b\f 5\f s28\kerning28 This is the 
Heading 1 Text 

If the target file is HTML, then the specification for the 
same style tag may look like the following line: 

Heading 1=<H1>; ;</Hl>;Y4 

The resulting HTML would be: 

<Hl>This is the Heading 1 Text</Hl> 



Feature Data Types 276 are now discussed. During translation 
the data of a feature may be placed between the beginning and end 
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code fragment. In a document format like MIF, RTF, or HTML, data is 
usually text that gets printed in the final document. The data can 
also be a number, file name, data tree, or other miscellaneous 
data. 

If the data needs to be rearranged or translated for inclusion 
in one of the file formats, the target data format or type needs to 
be specified in the tag file. For instance, if the data is binary, 
byte order and data size may have to be specified. If the data is 
a measurement, the unit of measure may have to be specified. The 
translation program then converts the data to the proper format. 
There may be a plug-in or scriptable architecture to provide data 
reformatting and translation beyond the built-in capabilities. 

Graphics may be external files, so the position of a graphic 
is indicated by a different feature than the data in a graphic. 
There are multiple graphic formats, each indicated by a different 
feature. A graphic feature group may be defined in the {dataType} 
section as follows: 

graphic= { $bitmapS ; $vector$ ; $photo$ } 

In the {featureLocation} section discussed below, the graphic 
feature group is also defined. In that section there are different 
features listed in the feature group definition. This associates 
the graphic formats in the {dataType} section with the graphic 
location features in the {featureLocation} section. In the HTML 
tag file the bitmap format is specified as follows: 

bitmap=gif 

In the RTF tag file the bitmap format is: 

bitmap=bmp 
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Like features, feature locations 270 alsoTave data types 276. 
Since grouping is used to link features to their corresponding 
locations, the group can be used to specify the feature location 
data type. In both the HTML and RTF tag files feature location 
data type may be specified as follows: 



graphic=%windowsFilePath% 



In some instances certain content in the source file has 
meaning that should be provided to a target file feature. For 
instance, in the MIF files written for on-line help by Wind River® 
Systems, Inc. (Alameda, California), the writers used a particular 
character tag to indicate a hypertext jump. If a different 
template were used to generate on-line help, a different character 
tag would be used for the same feature. The tag file must indicate 
to the translation program how to identify these user specific 
features. These are referred to as implied features 278. Implied 
feature definitions are changed when the user changes the way the 
source file is used. These features are not necessarily changed 
when the target format changes. In one example, if a linkJump font 
tag feature is encountered, a jumpLink feature sequence is implied. 
The data in the linkJump font tag becomes the data in the jumpText 
feature that is contained within a jumpLink feature sequence. 



[impliedFeatures] 

jumpText= [f eatureOrder ] linkJump [fntTags] 



When the translator encounters a linkJump font style, it finds 
jumpText in f eatureOrder, and sees that jumpText is part of a 
jumpLink feature sequence. The other part of the sequence is 
jumpID. If the translator front-end has both parts, it sends a 
jumpLink feature to the back-end. The back-end then generates and 
start code for the jumpLink feature, then writes the jumpText and 
jumpID features in the correct order. When the back-end writes the 



Docket No.: 2000^^/1109.007 ^ 

jumpText feature it generates start code for that feature, then 
generates start code for the linkJump font feature, then writes the 
text data, then writes the end code for both features. 

Discontinuity Indicators 268 are now described. Some features 
in the source file can disrupt the sequential organization of the 
main body in the target format. This discontinuity either 
redirects the main body to another position within the same file, 
or redirects the main body to a different file. For example, each 
topic in an HTML-based help system like JavaHelp® is contained in a 
new file. The "new topic" feature redirects the main body to a new 
file. This new topic feature is implied by heading character tag 
features. The redirect type and the feature that signals 
redirection should be indicated in the tag file. For example, the 
newTopic feature is implied by various heading paragraph tags. This 
is defined in the { impliedFeatures} section: 

newTopic=[redirect] {$ChName$ [pgfTags] ;$H2$ [pgfTags] ; $H3S [pgf Tags] } 

The {redirect} section then indicates that newTopic features start 
a new file: 

newTopic=NEWFILE 

When a ChName, H2, or H3 paragraph is encountered, the translation 
will use the definitions in other sections to write a newTopic 
feature (The newTopic feature is usually written as a link to the 
next topic. This link is usually placed at the top and bottom of 
the current topic.) Once the newTopic feature is written, the 
translator will start a new file (with a name based on the 
paragraph data) , then after the file header place the paragraph 
which triggered the new file. 

With regard to feature Locations 270, a feature can be written 
in the main file header, in a separate file, in the main body of 
the file, or after the main body of the file. If the tag file 
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5 specifies that the feature is written somewhere other than the main 
file body, the tag file may also specify how the target format 
associates the feature data with the location. For instance, in a 
MIF file tables are written before the main text flow of the 
document. Each table has an ID which is used to indicate where the 

10 table is in the main text flow. If a tag file were created to write 
MIF files, it would need to specify how the ID is written in the 
table, and how the ID is written in the main text flow. The tag 
file would also need to specify that the table gets written before 
the main text flow, rather than within the flow as it is with RTF 

15 or HTML files. Graphics are typically external files imported into 
the target format by reference. Graphics may be specified in the 
{featureLocations} section as follows: 



The first line indicates the location features that are graphic 
locations. The second line indicates that the data for a graphic 
is placed in an external file. The name of the external file is 
specified by the location data. If a file name is not specified, 



Data Translation Pairs 272 are now discussed. In document 
formats there are usually special characters that either need to be 
escaped in the source or target text. The existence of escaped 
characters needs to be indicated in the tag file, and the 



30 translation from source character to target character needs to be 
specified as a data translation pair in the tag file. There are no 
field indicators, macro indicators, or group indicators in a pair 
specification. If an equal sign needs to be used in the source 
specification of the pair, this may be indicated as %EQUAL%. For 

35 example, the following replaces FrameMaker® codes for an ampersand, 
less than, and greater than with the corresponding HTML code. In 
this section all punctuation is read literally. 



graphic=($graphicLef t; graphicRight; graphicCharacter$ } 
graphic=EXTERNAL 
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[replacePairs] 
& = & amp ; 
<=< 
\>=> 



10 The locations of feature parameters sometimes may be indicated 

within the beginning and end code fragments as variables. That is, 
there is a place-holder in the code fragment that indicates "this 
parameter goes here". Like other instances of variables, this is a 
convenience that can be avoided with proper selection of features. 
15 The parameter can be something read directly from the source 
format, or can be derived from data in the source format. The 
parameter can be a single item, a list of items, or more structured 
data like a data tree. The units and data types of the target 
5-- parameters are specified in the tag file. The translation program 
SJ 20 then has utilities that convert the source parameters to the target 
% units and data types. These unit and data type conversion 

fij utilities should also be extensible through plug-ins or scripting. 

j*j Generally a single feature can be broken into multiple feature 

definitions in the tag file to avoid using variables and to make 
H 25 the tag file easier to read and debug. For instance, MIF, and HTML 
each have a feature to imbed a bitmap in text. This feature has a 
n'' parameter that specifies the position of the graphic relative to 
I* its location in the text stream. Instead of defining one bitmap 

feature with a location parameter specified as a macro in the tag 
30 file, the tag file defines multiple bitmap features, each with a 
different location (e.g. graphicLeft, graphicCharacter, 
graphicRight, graphicRunln, etc.) 

In a file that specifies an HTML target, the positioning of a 
graphic could be defined as a variable. In this case, the code 
35 fragment specification for a graphic may be: 

graphic=<IMG ALIGN="%Alignment%" SRC=";> 
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To avoid using a variable, the graphic feature is split into three 
different features. The syntax used to write a left justified 
graphic may then specified as follows: 



graphicLeft=<IMG ALIGN= "LEFT " SRC=";"> 



10 For the bitmap agraphic.bmp, the resulting HTML would be: 

<IMG ALIGN= "LEFT " SRC=" agraphic .bmp"> 

In the RTF specification, the same feature may be specified as 
follows : 

□ 15 graphicLeft=\{bml ;\} 

5 For the bitmap "agraphic.bmp" the resulting RTF would be: 

],2 \{bml agraphic.bmp\} 

■ 

Ui 

i. In both formats the feature data type is defined (in the {dataType} 

^'20 section) as: 

; =-r . • graphicLef t=%windowsFilePath% 

I s *- 

Implied feature endings 280 are now discussed. In some 
instances the source format does not clearly indicate where a 

25 feature ends. For instance, in FrameMaker there is generally no 
way to indicate the end of a numbered or bulleted list. The list 
is assumed to end whenever one of a collection of styles is 
encountered. Typically this includes the paragraph tags "Body", 
"Heading 1", "Heading 2", "Heading 3", etc. The tag file must 

30 indicate feature endings that are implied, and must list the 
features which signal the feature ending. 

In HTML a numbered list begins with a <ol>. Each item in the 
list begins with a <li> and ends with a </li>. The numbered list 
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then ends with a </ol>. In FrameMaker a numbered list begins with a 
paragraph tag like NumberedFirst . This paragraph begins the first 
item in the list. The first item ends with the beginning of the 
next item. The next item begins with a paragraph tag like 
Numbered. The list ends when a normal paragraph like Body, H2, H3, 
H4 etc. is encountered. This structure has two implied feature 
beginnings and two implied feature endings. The implied beginnings 
are defined in the { impliedFeatures } section. 

nuniList^NumberedFirst 

numltem= { $NuinberedFirst$ ; $Numbered$ } 

The implied feature endings are then defined in the {featureEnd} 
section. 

numList= { $Body$ ; $Ch#$ ; $H2 $ ; $H3$ ; $H4$ ; $HU$ ; $HU-Run$ ; $TaskIntro$ } 
numItem-{ $Numbered$ ; $Body$ ; $Ch#$ ; $H2$ ; $H3$ ; $H4$ ; $HU$ ; $HU- 
Run$ ; $TaskIntro$ } 

The numList and numltem features are then defined in the code 
fragments section. 

numList=<ol>; ;</ol> 
numltem=<li>; ;</li> 



An additional exemplary tag file useful as a front-end file 
120, 220, is also included as Example 5 of Appendix A. As 
discussed herein, 

Embodiments of the foregoing invention may advantageously be 
used to translate text formats, graphic formats, debugging 
information formats, GUI framework source code, or nominally any 
other file format. As a particular example, these embodiments may 
be useful for producing Wind River® SingleStep® on-line 
documentation. The embodiments may also be useful as a tool for 
producing Wind River® Tornado™ on-line documentation and may be 
useful as a tool to produce documents for other on-line help 
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5 systems, such as on-line help displayed with the Wind River® 

ICEBrowser™. Other implementations of embodiments of the present 
invention may be used in substantially any situation in which 
translation from one or two source formats to a wide variety of 
target formats is desired. Examples of such applications include: 
10 document publishing, page layout, vector graphics, 3D graphics, 
word processors, spreadsheets, and databases. One implementation 
that may be of particular interest is as a programming framework 
translation tool. Such an implementation may read MFC (Microsoft® 
Foundation Class) files (resource, header, C, and C++ files), then 
15 translate code for GUI features and other high-level features to 

code for corresponding features in other frameworks that compile to 
other targets, such as UNIX, Macintosh™ (Apple Computer Inc.), Palm 
(Palm, Inc. Santa Clara, California), other handhelds and displays, 
%J' etc. Such embodiments of the present invention may be 
£'20 advantageously used by programmers skilled in conventional (i.e., 
1=1 non-embedded) programming for embedded system programming. 

Additional uses for embodiments of the present invention include 
translation of executable formats such as ELF/ DWARF to other 
formats such as the SDS SingleStep object file format. If such a 
M= 25 translation were effected, it may then be used to translate to new 

formats as they are introduced. For instance, if one were to 
W develop a binary XML-like executable format, embodiments of the 

present invention may be used to quickly develop a translation from 
ELF/ DWARF to that new format. 
30 Although embodiments of the present invention have been 

described that include both front-end and back-end lookup tables, 
the skilled artisan should recognize that substantially any file 
translator having a back-end lookup table, regardless of whether or 
not a front-end lookup table is used, should be considered to be 
35 within the spirit and scope of the present invention. For example, 
a file translator having a front-end lexical analyzer and/or parser 
such as described hereinabove with respect to the LEX and YACC 
languages, while using a back-end lookup table as set forth 
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hereinabove, is within the spirit and scope of the present 
invention. 

In the preceding specification, the invention has been 
described with reference to specific exemplary embodiments thereof. 
It will be evident that various modifications and changes may be 
made thereunto without departing from the broader spirit and scope 
of the invention as set forth in the claims that follow. The 
specification and drawings are accordingly to be regarded in an 
illustrative rather than restrictive sense. 

Having thus described the invention, what is claimed is: 
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